cutKey

Type

message

Summary

Sent when the user presses the key combination equivalent to the Cut menu item.

Syntax

cutKey

Description

Handle the cutKey message if you want to change the normal cut process, or prevent use of the Cut keyboard equivalent without changing the menu.

The LiveCode development environment traps the cutKey message. This means that the cutKey message is not received by a stack if it's running in the development environment, To test a cutKey handler, choose Development → Suspend Development Tools from the menubar.

cutKey message is sent when the user presses Command-X (on Mac OS systems), Control-X (on Windows systems), Shift-Delete (on Unix systems), or the keyboard Cut key.

The message is sent to the active (focused) control, or to the current card if no control is focused.

Examples

on cutKey
  if word 1 of the focusedObject is "card" then
    answer error "Cannot cut a card."
  else pass cutKey
end cutKey

Related

command: delete, cut

glossary: menu item, key combination, handler, Windows, development environment, message, Mac OS, Unix, keyboard equivalent

message: pasteKey, backspaceKey, deleteKey, undoKey, copyKey

object: stack

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

Platforms

desktop

server